Summary

Creates a button or link that opens a new window and loads the document specified by a given URL.

Component properties
Category AS Document
Version 1.0
Complies with Xhtml 1.0 / 1.1 rules Yes
Supported server programming languages C# Visual Basic.NET
Output content type inline

When to use

This component is typically used when there is a need to open a new browser window with the content of a specific Url.

Programming interface

Parameters

Label
Label for button/link
Link
Creates a link
Button
Creates a button
Class
Class for button/link
ID
ID for the document to display.
PTID
Optional presentation template ID.
Size and positioning
Height
Specifies the height of the window, in pixels. The minimum value is 100.
Width
Sets the width of the window, in pixels. The minimum value is 100.
Top
Specifies the top position, in pixels. This value is relative to the upper-left corner of the screen.
Left
Specifies the left position, in pixels. This value is relative to the upper-left corner of the screen.
Options
Channel mode
Specifies whether to display the window in theater mode and show the channel band. The default is no.
Directory buttons
Specifies whether to add directory buttons. The default is yes.
Fullscreen
Specifies whether to display the browser in full-screen mode. The default is no. Use full-screen mode carefully. Because this mode hides the browsers title bar and menus, you should always provide a button or other visual clue to help the user close the window. ALT+F4 closes the new window.
Location field
Specifies whether to display the input field for entering URLs directly into the browser. The default is yes.
Menu bar
Specifies whether to display the menu bar. The default is yes.
Resizable
Specifies whether to display resize handles at the corners of the window. The default is yes.
Scrollbars
Specifies whether to display horizontal and vertical scroll bars. The default is yes.
Status bar
Specifies whether to add a status bar at the bottom of the window. The default is yes.
Title bar
Specifies whether to display a title bar for the window. This parameter is ignored unless the calling application is an HTML Application or a trusted dialog box. The default is yes.
Tool bar
Specifies whether to display the browser toolbar, making buttons such as Back, Forward, and Stop available. The default is yes.
Replace entry in history list
Optional. When the sURL is loaded into the same window, this Boolean parameter specifies whether the sURL creates a new entry or replaces the current entry in the windows history list.
Name
Optional. String that specifies the name of the window. This name is used as the value for the TARGET attribute on a form or an a element.
Common values are:
  • _blank
    The url is loaded into a new, unnamed window.
  • _parent
    The sURL is loaded into the current frames parent. If the frame has no parent, this value acts as the value _self.
  • _search
    Available in Microsoft® Internet Explorer 5 and later. The sURL is opened in the browser's search pane.
  • _self
    The current document is replaced with the specified sURL
  • _top
    sURL replaces any framesets that may be loaded. If there are no framesets defined, this value acts as the value _self.

Remarks

---